home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / srs.arc / SR.DOC next >
Encoding:
Text File  |  1985-09-30  |  52.9 KB  |  2,707 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                   Still River Shell
  15.  
  16.                                User and Reference Guide
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                             Abridged Diskette Version 1.19
  28.  
  29.                                   September 30, 1985
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                             (c) Copyright Bob Howard 1985
  36.                                  All rights reserved.
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           Still River Shell
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                              Table of Contents
  76.  
  77.  
  78.           Chapter 1 License                                           3
  79.  
  80.              1.1 Bearer License                                       3
  81.              1.2 User Support                                         3
  82.              1.3 Acknowledgments                                      3
  83.  
  84.           Chapter 2 User Guide                                        4
  85.  
  86.              2.1 The Still River Shell                                4
  87.              2.2 Optional Performance Consideration                   5
  88.              2.3 Futures                                              5
  89.              2.4 Note of Caution                                      5
  90.              2.5 Demonstration Session                                7
  91.  
  92.                 2.5.1 Set Up                                          7
  93.                 2.5.2 Initial Screen                                  8
  94.                 2.5.3 Sample Operations                               8
  95.  
  96.           Chapter 3 Reference Guide: Command Summary                  12
  97.  
  98.              3.1 CHDIR                                                13
  99.              3.2 COPY                                                 14
  100.              3.3 DELETE                                               16
  101.              3.4 FIND                                                 17
  102.              3.5 INFO                                                 18
  103.              3.6 LIST                                                 19
  104.              3.7 MOVE                                                 21
  105.              3.8 OPTIONS                                              23
  106.              3.9 RENAME                                               25
  107.              3.10 SORT                                                26
  108.              3.11 TREE                                                27
  109.              3.12 VIEW                                                28
  110.              3.13 WRITE                                               29
  111.              3.14 XDOS                                                30
  112.              3.15 <function_key>                                      32
  113.  
  114.           Chapter 4 User Guide: Still River Shell Techniques          34
  115.  
  116.              4.1 High Performance Option                              34
  117.              4.2 Second Operand Selection                             34
  118.              4.3 Restoring the Screen                                 35
  119.              4.4 Media Replacement                                    35
  120.  
  121.                 4.4.1 Insufficient Space                              36
  122.                 4.4.2 Change of System Default Drive Media            36
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.           Still River Shell
  134.  
  135.  
  136.  
  137.              4.5 Backup a Directory                                   36
  138.              4.6 Restore a Directory                                  37
  139.              4.7 Rename a Directory                                   37
  140.              4.8 Command <function_key> Usage                         38
  141.  
  142.                 4.8.1 Print a File                                    38
  143.                 4.8.2 Edit a File                                     39
  144.                 4.8.3 Execute a File                                  39
  145.                 4.8.4 Transmit a File                                 39
  146.                 4.8.5 Backup the Set                                  39
  147.                 4.8.6 Shell Help                                      40
  148.                 4.8.7 FIND List <function_key>                        40
  149.                 4.8.8 Command Key Definition Standards                40
  150.  
  151.              4.9 Saving and Using Shell File Lists                    40
  152.              4.10 Hints For Using Hard Disks                          41
  153.  
  154.                 4.10.1 Shared Logic Directory                         41
  155.                 4.10.2 Prevent Accidental Formatting                  42
  156.                 4.10.3 Improve Hard Disk Performance                  42
  157.  
  158.              4.11 Memory Usage                                        43
  159.  
  160.                 4.11.1 Nested Shell Calls                             43
  161.                 4.11.2 Out of Memory - Command Response               44
  162.                 4.11.3 Memory Cost                                    45
  163.  
  164.           Chapter 5 Reference Guide: Command Usage                    46
  165.  
  166.              5.1 Usage                                                46
  167.  
  168.                 5.1.1 Command Syntax                                  46
  169.                 5.1.2 Command Window                                  46
  170.                 5.1.3 Command Set                                     46
  171.                 5.1.4 Command Selection                               46
  172.                 5.1.5 Command Edit                                    47
  173.                 5.1.6 Command Execution                               48
  174.                 5.1.7 Command Response                                48
  175.                 5.1.8 Command Object Set                              48
  176.                 5.1.9 Command Extensions                              48
  177.  
  178.                    5.1.9.1 Query                                      48
  179.                    5.1.9.2 Media Replacement                          49
  180.                    5.1.9.3 Target File Protection                     49
  181.  
  182.                 5.1.10 User Defined Commands                          49
  183.  
  184.           Chapter 6 Reference Guide: Window Definitions               51
  185.  
  186.              6.1 Initial Command Selection Presentation               51
  187.  
  188.                 6.1.1 Set List Window                                 51
  189.                 6.1.2 Data Window                                     51
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.           Still River Shell
  200.  
  201.  
  202.  
  203.                 6.1.3 Command Window                                  52
  204.  
  205.              6.2 FIND Presentation                                    53
  206.  
  207.                 6.2.1 Set List Window                                 53
  208.                 6.2.2 Data Window                                     53
  209.                 6.2.3 Command Window                                  54
  210.  
  211.              6.3 TREE Presentation                                    54
  212.  
  213.                 6.3.1 Set List Window                                 54
  214.                 6.3.2 Data Window                                     55
  215.                 6.3.3 Command Window                                  56
  216.  
  217.              6.4 Object Set List Window                               56
  218.  
  219.           Chapter 7 Reference Guide: Message Summary                  57
  220.  
  221.              7.1 Shell Informational Messages                         57
  222.              7.2 Query Messages                                       59
  223.  
  224.           Chapter 8 A Little Design Philosophy                        61
  225.  
  226.           Index                                                       
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.           Still River Shell                                         License
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.                                       Chapter 1
  276.  
  277.                                        License
  278.  
  279.  
  280.  
  281.  
  282.           1.1 Bearer License
  283.  
  284.  
  285.           This abridged documentation is intended for diskette distribution
  286.           with the Still River Shell program.  You may  copy and distribute
  287.           this documentation as long as you make  no change to the document
  288.           or charge a fee beyond media and handling ($9 Max).  See the INFO
  289.           command in the shell program for information about obtaining  the
  290.           printed, unabridged documentation  and  the latest version of the
  291.           program.
  292.  
  293.  
  294.  
  295.  
  296.           1.2 User Support
  297.  
  298.  
  299.           If  you  use the shell, please help underwrite the  cost  of  its
  300.           development by sending us a small contribution.  See the  shell's
  301.           INFO  command  to  find  out how to  make  a  contribution  which
  302.           entitles you to program  update  notices  and  a  credit  towards
  303.           orders of  future  versions.   Your  support  now  will  help  us
  304.           continue our work and make future releases possible.
  305.  
  306.  
  307.  
  308.  
  309.           1.3 Acknowledgments
  310.  
  311.  
  312.           Thanks to all who helped including the Boston Computer  Society's
  313.           PC Technical  Group  which  supplied many of our Beta Testers and
  314.           much needed encouragement.  Almost all of the program was written
  315.           using  Lattice  C.  The  documentation  was  prepared  using  The
  316.           FinalWord word processor.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                                         - 3 -
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.           Still River Shell                                    Introduction
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.                                       Chapter 2
  342.  
  343.                                       User Guide
  344.  
  345.  
  346.  
  347.  
  348.           2.1 The Still River Shell
  349.  
  350.  
  351.           The Still River Shell  presents  an  enhanced PC-DOS environment.
  352.           The shell  allows  the  DOS user much greater efficiency than the
  353.           standard  DOS  interface  affords.    Typical  DOS  functions  of
  354.           executing, finding,  copying,  moving,  deleting  and  listing of
  355.           files and directories can be done with  significantly  fewer  key
  356.           strokes when using the  Still  River  Shell; recursive operations
  357.           produce  even  greater efficiencies.  And the  shell  provides  a
  358.           natural, intuitive interface which makes using DOS both more  fun
  359.           and more productive.
  360.  
  361.           You save a lot of work and  time  using  the  Still  River  Shell
  362.           through  the  substantial  elimination  of  command  and  operand
  363.           typing.  The shell allows you to use directly system information,
  364.           such as file and directory lists, without having to copy the data
  365.           from the screen  and  reenter  it  on your command line.  You can
  366.           select common commands without typing them.  You can recall, edit
  367.           and reenter DOS commands  from  the  shell's  prior  DOS  command
  368.           stack.   A  powerful  feature  allows  you  to  define  your  own
  369.           extensions to the Still River Shell's command set.   The  Shell's
  370.           full screen, real time presentation  makes  it  an  ideal  system
  371.           interface for  mass  storage  systems  such  as  the  IBM/XT  and
  372.           IBM/AT.
  373.  
  374.           We could go on about the virtues of the shell,  as  we  did in an
  375.           earlier version of this document, but the best  way  to  find out
  376.           about the shell is to use it.  The shell  is  designed to grow on
  377.           you; you can use the shell  productively  right  away  while  you
  378.           learn about its  other  features.   You  may  find  it helpful to
  379.           follow  along  during  the  demonstration session and  to  review
  380.           briefly the commands in the reference guide.
  381.  
  382.           We  hope  you  like  the  Still  River Shell as much  as  we  do.
  383.           Remember, it is now your program too!   Help support the Shell by
  384.           sending your comments and  contribution  (see  the INFO command).
  385.           Thank you for your interest and support.
  386.  
  387.  
  388.  
  389.  
  390.                                         - 4 -
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.           Still River Shell                                    Introduction
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.           2.2 Optional Performance Consideration
  406.  
  407.  
  408.           The shell's performance, as well as that of  many other programs,
  409.           is much improved by  instructing  PC-DOS  to  keep  a  pool of IO
  410.           Buffers numbering 14 or so.  These buffers,  used by DOS to speed
  411.           up disk  reads,  are allocated by PC-DOS at "boot" time either by
  412.           default or as specified in the CONFIG.SYS file.
  413.  
  414.           Either  edit  an existing CONFIG.SYS file or, if there  is  none,
  415.           create  a  new one.  The CONFIG.SYS file should be  in  the  root
  416.           directory (\).  The CONFIG.SYS should read in part:
  417.  
  418.  
  419.           BUFFERS=14
  420.  
  421.           If  you  prepare  that  file now,  we  can  BOOT  under  our  new
  422.           configuration.  If you do not wish  to do it now, try to remember
  423.           to do it later.
  424.  
  425.  
  426.  
  427.  
  428.           2.3 Futures
  429.  
  430.  
  431.           For every published work there comes a time when you have to say:
  432.           "It's done" or  at  least  "Version  1 is done".  When, after two
  433.           years  of  design and development, that time came for  the  Still
  434.           River Shell, some of what we  intended was not there.  We hope to
  435.           add, with your support, additional functions in the future.
  436.  
  437.           How the Shell develops in the  future depends a great deal on the
  438.           experiences and wishes of you,  the  shell  user  and  supporter.
  439.           Suggestions  accompanied  by contributions will be  accorded  the
  440.           attention they deserve!  In fact, it is  you, the shell user, who
  441.           will decide if there will be any future  releases  of  the shell.
  442.           We can not continue our work without your support.
  443.  
  444.  
  445.  
  446.  
  447.           2.4 Note of Caution
  448.  
  449.  
  450.           The Still River Shell is a powerful system utility and you should
  451.           take  care  when using it.  While the shell has  had  significant
  452.           design work to help insure proper operation as  well as extensive
  453.  
  454.  
  455.  
  456.                                         - 5 -
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.           Still River Shell                                    Introduction
  464.  
  465.  
  466.  
  467.           ALPHA and BETA testing to insure its proper execution, the shell,
  468.           like all programs, can fail, or  a user, like all users, can err.
  469.           Operation of the shell is at the user's risk.
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.                                         - 6 -
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.           Still River Shell                                    Introduction
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.           2.5 Demonstration Session
  538.  
  539.  
  540.           2.5.1 Set Up
  541.  
  542.           Please prepare  a  diskette  with  only  the  Still  River  Shell
  543.           (SR.EXE) on  it;  we will use this diskette as our practice area.
  544.           Mount the diskette on Drive A.
  545.  
  546.           Now, select the system default drive  and  a  directory  with  at
  547.           least 25 files,  the  more  the  better,  as  the current default
  548.           directory.   You  may  do  this  when  you  start  the  shell  by
  549.           specifying:
  550.  
  551.  
  552.           ?>A:SR C:\MYDIR
  553.                           start the shell (A:SR)
  554.                           select system default drive (C:)
  555.                           select system current directory (\MYDIR)
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.                                         - 7 -
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.           Still River Shell                           Demonstration Session
  596.  
  597.  
  598.  
  599.  
  600.  
  601.           2.5.2 Initial Screen
  602.  
  603.           When the shell starts, it presents the initial screen.
  604.  
  605.           As you can see,  there  are  three main areas, or windows, on the
  606.           initial screen:
  607.  
  608.  
  609.                   =================================
  610.                   |               |               |
  611.                   |               |               |
  612.                   |               |               |
  613.                   |               |               |
  614.                   |      SET      |     DATA      |
  615.                   |               |               |
  616.                   |               |               |
  617.                   |               |               |
  618.                   |               |               |
  619.                   =================================
  620.                   |           COMMAND             |
  621.                   =================================
  622.  
  623.             -  Set List Window on the left is used to list the selected set
  624.                of files and directories, <selected_set>.
  625.  
  626.             -  Data Window  on the right contains summary information about
  627.                the <default_drive>, <selected_directory> and <selected_set>
  628.                or other context sensitive data.
  629.  
  630.             -  Command Window at the bottom of the screen is used to select
  631.                and to  enter  commands  as well as to receive responses and
  632.                obtain help.
  633.  
  634.  
  635.           2.5.3 Sample Operations
  636.  
  637.           Now that you have the shell  started,  try  the  following  shell
  638.           operations:
  639.  
  640.           To copy a file from the <selected_set> to  the practice diskette,
  641.           perform the following steps:
  642.  
  643.             1.  You select a command by entering the letter, upper or lower
  644.                 case, equal to the upper  case  letter in the command name.
  645.                 In the case of COPY, <C>.  The <selected_command>  and  the
  646.                 <selected_file> appear on the command  input  line  in  the
  647.                 Command Window.
  648.  
  649.             2.  Move the file <selector> with the <UP/DOWN CURSOR> keys  to
  650.                 the file you wish to copy.  Note: that the first operand on
  651.  
  652.  
  653.  
  654.                                         - 8 -
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.           Still River Shell                           Demonstration Session
  662.  
  663.  
  664.  
  665.                 the command line changes as you move the <selector>.
  666.  
  667.             3.  Enter the <to_file> operand, in this case, <A:>
  668.  
  669.             4.  Enter <CR> to execute the command.
  670.  
  671.           To copy another file to A:,
  672.  
  673.             1.  Move the file <selector> to the file you wish to copy.
  674.  
  675.             2.  Enter <CR> to execute the copy.
  676.  
  677.           To copy some but not all files  with a particular extension, e.a.
  678.           <.BAT>:
  679.  
  680.             1.  Enter <ESC> to return to command selection.
  681.  
  682.             2.  Enter <S> to select sort.
  683.  
  684.             3.  Enter <E> to sort by extension.
  685.  
  686.             4.  Enter <ESC> to return to command selection.
  687.  
  688.             5.  Enter <C> to select copy.
  689.  
  690.             6.  Move the file <selector> to the first file with the desired
  691.                 extension.
  692.  
  693.             7.  Enter <A:> to set <to_file>.
  694.  
  695.             8.  Enter <CR> to execute the copy.
  696.  
  697.             9.  Move to the file <selector> to the next file to be copied.
  698.  
  699.             10. Enter <CR> to execute the copy.
  700.  
  701.             11. Repeat the last two steps  until each file you wish to copy
  702.                 is copied.
  703.  
  704.           To  edit  the  command  line  to  copy  all  files of a  specific
  705.           extension, e.a.  <.BAT>
  706.  
  707.             1.  Position the command line cursor at the first letter of the
  708.                 <from_file> in the command text.  For example:
  709.  
  710.                 COPY LAST.BAT A:
  711.                      ^
  712.  
  713.             2.  Delete the first part of the  filename  by  entering  <DEL>
  714.                 until the <from_file> is deleted up to the period  changing
  715.                 <LAST.BAT> to <.BAT>.
  716.  
  717.  
  718.  
  719.  
  720.                                         - 9 -
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.           Still River Shell                           Demonstration Session
  728.  
  729.  
  730.  
  731.             3.  Enter <*> so the command line reads <COPY *.BAT A:>.
  732.  
  733.             4.  Enter <CR> to execute the copy.   Note:  the  copy  command
  734.                 places a list of the files copied in the Set List Window.
  735.  
  736.             5.  Enter <ESC> to return to command selection.
  737.  
  738.           To List a new current directory:
  739.  
  740.             1.  Enter <L> to select LIST function.
  741.  
  742.             2.  Enter <directory_name>.
  743.  
  744.             3.  Enter <CR> to execute the change  directory  and  list  all
  745.                 files in the new directory.
  746.  
  747.           To enter and execute a PC-DOS command:
  748.  
  749.             1.  Enter <X> to select the EXECUTE DOS command presentation.
  750.  
  751.             2.  Enter <DIR *.*><CR> to execute command under DOS.
  752.  
  753.             3.  Enter <DATE><CR> to execute command under DOS.
  754.  
  755.             4.  Respond to DATE with <CR>.
  756.  
  757.           To recall your prior DOS commands:
  758.  
  759.             1.  Enter the <UP CURSOR>  twice.   You  should  see  the  DATE
  760.                 command and then the DIR command.
  761.  
  762.             2.  Move the cursor to the first  <*>  and  delete  <*.*>  with
  763.                 <DEL>.
  764.  
  765.             3.  Replace  the  deleted operand with the  <selected_file>  by
  766.                 entering <INS>.
  767.  
  768.             4.  Enter <CR> to execute the edited command line.
  769.  
  770.             5.  Enter <ESC> to return to command selection.
  771.  
  772.           To delete some of the files on a:
  773.  
  774.             1.  Enter <L> to select the LIST function.
  775.  
  776.             2.  Enter <A:> to select a new DOS default drive to A
  777.  
  778.             3.  Enter <CR> to change <default_drive>,  list  all  files  on
  779.                 <drive a:>'s current directory.
  780.  
  781.             4.  Move the file <selector> to the first file to be deleted.
  782.  
  783.  
  784.  
  785.  
  786.                                         - 10 -
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.           Still River Shell                           Demonstration Session
  794.  
  795.  
  796.  
  797.             5.  Enter <D> to select the delete command.
  798.  
  799.             6.  Enter <CR> to delete the file.
  800.  
  801.             7.  Move the file  <selector>  to  the  next  file  you wish to
  802.                 delete.
  803.  
  804.             8.  Enter <CR> to delete the file.
  805.  
  806.             9.  Enter <ESC> to return to command selection.
  807.  
  808.           You are on your way!   Try the TREE command next, it gives a nice
  809.           visual  presentation  of  your  directory  structure  as well  as
  810.           allowing you  to  MAKE,  REMOVE or LIST directories.  Try all the
  811.           commands.  Watch out for DELETE  and  MOVE; they can delete files
  812.           you may miss.
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.                                         - 11 -
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.           Still River Shell                                 Command Summary
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.                                       Chapter 3
  870.  
  871.                            Reference Guide: Command Summary
  872.  
  873.  
  874.  
  875.           The following is a summary of the Still River Shell commands.
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.                                         - 12 -
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.           Still River Shell                                           CHDIR
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.           3.1 CHDIR
  934.  
  935.  
  936.           Command         CHDIR
  937.  
  938.           Function        To change the current  directory under the shell,
  939.                           use the LIST command  or  the  LIST subcommand of
  940.                           the TREE command.
  941.  
  942.           Operand 1
  943.  
  944.           Operation
  945.  
  946.           Options
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.                                         - 13 -
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.           Still River Shell                                            COPY
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.           3.2 COPY
  1000.  
  1001.  
  1002.           Command         COPY <from_file_set> [<to_file_set>] [/Q]<CR>
  1003.  
  1004.           Function        The COPY command  copies  the  entire contents of
  1005.                           the <from_file> creating a new <to_file>.
  1006.  
  1007.           Operand 1       <from_file_set>    Any    standard   DOS   file
  1008.                           specification
  1009.                           [<drive>:][\][<directory>\][<file_name>].
  1010.  
  1011.           Operand 2       <to_file_set> Any standard DOS file specification
  1012.                           or blank.
  1013.  
  1014.           Operation       COPY FILEA FILEB
  1015.  
  1016.                           Copies FILEA to FILEB in the current directory.
  1017.  
  1018.                           COPY *.ASM \SAVE
  1019.  
  1020.                           Copies all files in the current directory with an
  1021.                           <.ASM> extension to the <\SAVE> directory.
  1022.  
  1023.                           Should there be no more room on the target  disk,
  1024.                           the copy prompts:
  1025.  
  1026.  
  1027.  
  1028.                           ^ insufficient space; retry on new disk? (y/n)
  1029.  
  1030.                           If you change the disk and enter  <Y>,  the  COPY
  1031.                           will resume copying the <file_set> starting  with
  1032.                           the complete file that did not fit on  the  prior
  1033.                           media.  You may use as many media as  you need to
  1034.                           complete the <file_set> COPY.
  1035.  
  1036.                           If you wish to concatenate  files,  use  the  DOS
  1037.                           COPY command.
  1038.  
  1039.                  1
  1040.           Options         Option (1) Write on existing files
  1041.  
  1042.  
  1043.  
  1044.           ----------
  1045.  
  1046.           1. See the OPTION Command
  1047.  
  1048.  
  1049.  
  1050.                                         - 14 -
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.           Still River Shell                                            COPY
  1058.  
  1059.  
  1060.  
  1061.                           Option (3) or </Q> Query on multiple operations.
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.                                         - 15 -
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.           Still River Shell                                          DELETE
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.           3.3 DELETE
  1132.  
  1133.  
  1134.           Command         DELETE <file_set> [/Q]<CR>
  1135.  
  1136.           Function        The  DELETE  command  deletes all  files  in  the
  1137.                           <file_set> specification.
  1138.  
  1139.           Operand 1       <file_set>  Any standard DOS  file  specification
  1140.                           [<drive>:][\][<directory>\][<file_name>].
  1141.  
  1142.           Operation       DELETE *.ASM
  1143.  
  1144.                           Deletes files in  the  current  directory with an
  1145.                           <.ASM> extension.   When a wild card, <*> or <?>,
  1146.                           is used in the file  name,  the  set  of  deleted
  1147.                           files is presented in the Set Window.
  1148.  
  1149.                           DELETE <selected_file>
  1150.  
  1151.                           Deletes  the highlighted, <selected_file> in  the
  1152.                           current set window.  After the <selected_file> is
  1153.                           deleted, an  adjacent file is selected as the new
  1154.                           <selected_file> in both  the  Set  Window and the
  1155.                           command line.
  1156.  
  1157.           Options         Option (3) or </Q> Query on multiple operations.
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.                                         - 16 -
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.           Still River Shell                                            FIND
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.           3.4 FIND
  1198.  
  1199.  
  1200.           Command         FIND <file_set><CR>
  1201.  
  1202.           Function        The  FIND  command  creates   an   ordered   list
  1203.                           (<drive>\<dir>\<file_name>) of all  files  within
  1204.                           the <file_set>.
  1205.  
  1206.           Operand 1       <file_set>  Any standard DOS  file  specification
  1207.                           [<drive>:][\][<directory>\][<file_name>].   NOTE:
  1208.                           Drive  and  directories can be specified  with  a
  1209.                           wild card <?>  or <*>.
  1210.  
  1211.           Operation       FIND FILEA.BAT
  1212.  
  1213.                           Lists  any  FILEA.BAT  in any  directory  on  the
  1214.                           current drive.
  1215.  
  1216.                           FIND C:*.*
  1217.  
  1218.                           Finds all files in all directories on disk <C:>.
  1219.  
  1220.                           FIND \DIR4\*.bat
  1221.  
  1222.                           Finds all <.BAT> files in directory \DIR4.
  1223.  
  1224.                           FIND \DIRX\*\*.BAT
  1225.  
  1226.                           Finds all <.BAT> files in any subdirectory of the
  1227.                           <DIRX> directory.
  1228.  
  1229.                           FIND \*\CMD\*.BAT
  1230.  
  1231.                           Finds all <.BAT> files in a <CMD> subdirectory of
  1232.                           any parent directory.
  1233.  
  1234.                           FIND *:*.*
  1235.  
  1236.                           Finds all files on all drives from a to z.
  1237.  
  1238.           Options         None.
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.                                         - 17 -
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.           Still River Shell                                            INFO
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.           3.5 INFO
  1264.  
  1265.  
  1266.           Command         INFO
  1267.  
  1268.           Function        The  INFO  command displays  license  information
  1269.                           including  our  address, suggested  contribution,
  1270.                           credits and how  to  order the latest versions of
  1271.                           the Still  River  Shell  program  and  unabridged
  1272.                           documentation.
  1273.  
  1274.           Operand 1       None.
  1275.  
  1276.           Operation       Strike any key to see next page.
  1277.  
  1278.           Options         None.
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.                                         - 18 -
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.           Still River Shell                                            LIST
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.           3.6 LIST
  1330.  
  1331.  
  1332.           Command         LIST [<drive>:] [<path>] [<file_set>] <CR>
  1333.  
  1334.           Function        The LIST  command  presents  an  ordered  list of
  1335.                           files     and     subdirectories      from      a
  1336.                           <selected_directory>  based   on  the  <file_set>
  1337.                           specification.  In addition, the LIST command can
  1338.                           change the system's  default  drive  and  current
  1339.                           directory to a specified drive or directory.  The
  1340.                           <selected_directory>  always  becomes the  system
  1341.                           current   directory   when   the   LIST   command
  1342.                           executes.
  1343.  
  1344.           Operand 1       <file_set>  Any standard DOS  file  specification
  1345.                           [<drive>:][\][<directory>\][<file_name>].
  1346.                           Default: <*.*>.
  1347.  
  1348.           Operation       The initial <file_set> list  is presented in file
  1349.                           name order.  If  a  directory is specified in the
  1350.                           <file_set>, the specified directory is listed and
  1351.                           it  becomes the default <selected_directory>  for
  1352.                           all subsequent shell  and  DOS  operations.  If a
  1353.                           drive  is  specified,  it  becomes  the  system's
  1354.                           default drive.  If a  drive  is  specified but no
  1355.                           directory is specified, the current directory  of
  1356.                           the drive is assumed.
  1357.  
  1358.                           LIST *.BAT
  1359.  
  1360.                           Lists  all  <.BAT> files in the  current  default
  1361.                           <selected_directory>.
  1362.  
  1363.                           LIST ..
  1364.  
  1365.                           Changes the default <selected_directory> from the
  1366.                           current  directory  to its parent and  lists  all
  1367.                           files in the new <selected_directory>.
  1368.  
  1369.                           LIST C:
  1370.  
  1371.                           Makes the <default_drive> drive  <C:>  and  lists
  1372.                           all  files  in  the  default  directory  for  the
  1373.                           drive.
  1374.  
  1375.                           LIST B:\
  1376.  
  1377.  
  1378.  
  1379.  
  1380.                                         - 19 -
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.           Still River Shell                                            LIST
  1388.  
  1389.  
  1390.  
  1391.                           Makes the <default_drive> drive  <B:>  and  lists
  1392.                           all files in the root directory of the drive.
  1393.  
  1394.                           LIST A:ACCT*.*
  1395.  
  1396.                           Assuming   the  <default_drive>  is  <C:>,   this
  1397.                           command  changes  the <selected_drive>  to  drive
  1398.                           <A:>, assumes the default  current  directory  of
  1399.                           the drive <A:> and lists all files in the default
  1400.                           directory  with  <ACCT>   in   the   first   four
  1401.                           characters of the file name.
  1402.  
  1403.           Options         None.
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.                                         - 20 -
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.           Still River Shell                                            MOVE
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.           3.7 MOVE
  1462.  
  1463.  
  1464.           Command         MOVE <from_file_set> [<to_file_set>] [/Q]<CR>
  1465.  
  1466.           Function        The MOVE command establishes the entire  contents
  1467.                           of the <from_file> under  the  identity  of a new
  1468.                           <to_file> name and deletes the <from_file>.
  1469.  
  1470.           Operand 1       <from_file_set>    Any    standard   DOS   file
  1471.                           specification
  1472.                           [<drive>:][\][<directory>\][<file_name>].
  1473.  
  1474.           Operand 2       <to_file_set> Any standard DOS file specification
  1475.                           or blank.
  1476.  
  1477.           Operation       If  the  <to_file>  is   not   established,   the
  1478.                           <from_file> is not deleted.
  1479.  
  1480.                           MOVE PROGA.ASM *.BAK
  1481.  
  1482.                           Renames PROGA.ASM to PROGA.BAK  within  the  same
  1483.                           directory.
  1484.  
  1485.                           MOVE C:\DIRA\*.* A:*.*
  1486.  
  1487.                           Copies all files in the DIRA directory of drive C
  1488.                           to drive A and deletes all files in DIRA.
  1489.  
  1490.                           If the <from_file> and  <to_file> occupy the same
  1491.                           disk,  the  MOVE  command   is  executed  with  a
  1492.                           rename.  If they do not occupy the same disk, the
  1493.                           MOVE is executed with a COPY and a DELETE.
  1494.  
  1495.                           Should there be no more room on the target  disk,
  1496.                           the MOVE prompts:
  1497.  
  1498.  
  1499.  
  1500.                           ^insufficient space; retry on new disk? (y/n)
  1501.  
  1502.                           If you change the disk and enter  <Y>,  the  MOVE
  1503.                           will resume copying the <file_set> starting  with
  1504.                           the complete file that did not fit on  the  prior
  1505.                           media.  You may use as many media as  you need to
  1506.                           complete the <file_set> move.
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.                                         - 21 -
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.           Still River Shell                                            MOVE
  1520.  
  1521.  
  1522.  
  1523.           Options         Option (1) Write on existing files
  1524.  
  1525.                           Option (3) or </Q> Query on multiple operations.
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.                                         - 22 -
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.           Still River Shell                                         OPTIONS
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.           3.8 OPTIONS
  1594.  
  1595.  
  1596.           Command         OPTIONS
  1597.  
  1598.           Function        The OPTIONS  command shows and sets the values of
  1599.                           shell system options.
  1600.  
  1601.           Operand 1       None.
  1602.  
  1603.           Operation       The  OPTIONS  command  presents  a  screen  which
  1604.                           allows  you  to list and edit  the  <option_set>.
  1605.                           The Option values determine  some of the behavior
  1606.                           of the shell.
  1607.  
  1608.                           You move the cursor to select the Option you wish
  1609.                           to edit.  The data making up the the option  list
  1610.                           are switches.  Switches are  one byte fields with
  1611.                           a fixed  set of alternative values from which you
  1612.                           choose.
  1613.  
  1614.                           You change the <selected_option> switch value  by
  1615.                           striking the <SPACE_BAR>.
  1616.  
  1617.           Option 1        Write over existing files (<Y> | <?>).
  1618.  
  1619.                             -  <Y> =  yes,  write  on  existing  files when
  1620.                                doing   a  COPY,  MOVE  or  WRITE  just   as
  1621.                                PC/MS-DOS does.
  1622.  
  1623.                             -  <?>  = prompt if a <to_file> already exists.
  1624.  
  1625.                           In the  following  example,  a  move  instruction
  1626.                           encounters an existing <to_file> with the  option
  1627.                           set to <?>.
  1628.  
  1629.  
  1630.  
  1631.                           MOVE *.BAT \DIR1\
  1632.                                      ^ \DIR1\RUN.BAT exists; write? (y/n)
  1633.  
  1634.                           The directory information of both  the  <to_file>
  1635.                           and  the  <from_file> are displayed in  the  Data
  1636.                           Window as you are prompted for a decision.
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.                                         - 23 -
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.           Still River Shell                                         OPTIONS
  1652.  
  1653.  
  1654.  
  1655.                             -  <Y> = The existing  <to_file> is replaced by
  1656.                                the <from_file>.
  1657.  
  1658.                             -  <N> = The operation is bypassed.
  1659.  
  1660.           Option 2        Remember second operand (<N> | <Y>).
  1661.  
  1662.                             -  <Y> = place second  operand of prior command
  1663.                                function  into  the current  command  line's
  1664.                                second operand position when the command  is
  1665.                                selected.
  1666.  
  1667.                             -  <N>  =  command  line starts  with  a  blank
  1668.                                second operand.
  1669.  
  1670.           Option (3) or </Q>
  1671.                           Query multiple operations (<Y> | <N>).
  1672.  
  1673.                             -  <Y> = prompt before  command  execution  for
  1674.                                each member of the selected set.
  1675.  
  1676.                             -  <N> = Do not prompt
  1677.  
  1678.                           For example:
  1679.  
  1680.  
  1681.  
  1682.                           DELETE *.BAT
  1683.                                  ^ RUN.BAT ? (y/n)
  1684.  
  1685.                             -  <Y> = execute the operation.
  1686.  
  1687.                             -  <N>  =  skip  operation;  prompt  for   next
  1688.                                operation, if any.
  1689.  
  1690.                           The </Q> on appropriate command lines sets Option
  1691.                           3 equal to <Y> for this execution of the command,
  1692.                           for example:
  1693.  
  1694.                           DELETE *.BAT /Q
  1695.  
  1696.                           would present  each file in the <.BAT> set before
  1697.                           execution.
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.                                         - 24 -
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.           Still River Shell                                          RENAME
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.           3.9 RENAME
  1726.  
  1727.  
  1728.           Command         RENAME
  1729.  
  1730.           Function        To rename a file, use the Shell's MOVE command.
  1731.  
  1732.           Operand 1
  1733.  
  1734.           Operation
  1735.  
  1736.           Options
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.                                         - 25 -
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.           Still River Shell                                            SORT
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.           3.10 SORT
  1792.  
  1793.  
  1794.           Command         SORT
  1795.  
  1796.           Function        The SORT command  sorts  the  current  <file_set>
  1797.                           list and determines LIST sort criteria.
  1798.  
  1799.           Operand 1       None.
  1800.  
  1801.           Operation       The sort has several  subcommands for sorting the
  1802.                           <file_set> list based on different criteria.  You
  1803.                           may  enter one or more subcommands selecting  the
  1804.                           appropriate letter.
  1805.  
  1806.                             -  DATE/TIME  Sorts   by   file   date/time  in
  1807.                                ascending order.
  1808.  
  1809.                             -  EXTENSION  Sorts   by   file   extension  in
  1810.                                ascending order.
  1811.  
  1812.                             -  NAME Sorts by file name in ascending order.
  1813.  
  1814.                             -  SIZE Sorts by file size in ascending order.
  1815.  
  1816.                           When  you  enter <ESC>, you return  to  the  main
  1817.                           Command Selection Line with the <file_set> as you
  1818.                           last sorted  it.   All  subsequent  LIST  command
  1819.                           <file_set> lists are sorted  by the criteria last
  1820.                           selected.
  1821.  
  1822.           Options         None.
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.                                         - 26 -
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.           Still River Shell                                            TREE
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.           3.11 TREE
  1858.  
  1859.  
  1860.           Command         TREE [<selected_directory>] <CR>
  1861.  
  1862.           Function        The  TREE  command displays both the  parent  and
  1863.                           subdirectory       structure        of        the
  1864.                           <selected_directory>.   In  addition,   you   may
  1865.                           "move"  up  and down the directory  structure  as
  1866.                           well as LIST, MAKE or REMOVE a directory.
  1867.  
  1868.           Operand 1       The  <selected_directory>   whose   parent   and
  1869.                           subdirectories  are  to be  displayed.   Default:
  1870.                           Current <selected_directory>.
  1871.  
  1872.           Operation       The  directory  tree  is  displayed  in  the  Set
  1873.                           Window.   The <UP/DOWN CURSOR> keys allow you  to
  1874.                           move  the  <selector>  to any  directory  in  the
  1875.                           list.   All  subcommand  operations  address  the
  1876.                           <selected_directory>.
  1877.  
  1878.                             -  LIST   requests   a   file   list   of   the
  1879.                                <selected_directory>.
  1880.  
  1881.                             -  MAKE creates a named subdirectory under  the
  1882.                                <selected_directory>.
  1883.  
  1884.                             -  REMOVE        deletes        an        empty
  1885.                                <selected_directory>.
  1886.  
  1887.                             -  TREE displays the  parent and subdirectories
  1888.                                of the <selected_directory>.
  1889.  
  1890.           Options         None.
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.                                         - 27 -
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.           Still River Shell                                            VIEW
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.           3.12 VIEW
  1924.  
  1925.  
  1926.           Command         VIEW [<selected_file> <CR>]
  1927.  
  1928.           Function        The VIEW  command displays the contents of a file
  1929.                           in character format.
  1930.  
  1931.           Operand 1       <selected_file>.
  1932.  
  1933.           Operation       Normally, you view the <selected_file>.  You  may
  1934.                           specify a file only.  If the <selector> is  on  a
  1935.                           directory;  then,  you may enter a  standard  DOS
  1936.                           file                                specification
  1937.                           [<drive>:][\][<directory>\][<file_name>].      No
  1938.                           wild cards, <?>  or <*>, permitted.
  1939.  
  1940.                           You select what area of the file to view with the
  1941.                           <HOME>, <END>, <PAGE UP/DN> and <CURSOR UP/DN>.
  1942.  
  1943.           Options         None.
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.                                         - 28 -
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.           Still River Shell                                           WRITE
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.           3.13 WRITE
  1990.  
  1991.  
  1992.           Command         WRITE <to_file><CR>
  1993.  
  1994.           Function        The WRITE command  copies the <selected_file_set>
  1995.                           list, created by the  LIST  or  FIND commands, to
  1996.                           the <to_file>.
  1997.  
  1998.           Operand 1       <to_file>  Any standard  DOS  file  specification
  1999.                           [<drive>:][\][<directory>\][<file_name>].
  2000.  
  2001.           Operation       The  WRITE  creates  a file  which  contains  all
  2002.                           members  of  the <selected_file_set>.   The  data
  2003.                           appears in the same form as the set is  presented
  2004.                           in the Set Window by the LIST or  FIND  commands.
  2005.                           The FIND set contains the path and file names  of
  2006.                           files from  one or more directories; the LIST set
  2007.                           contains  the  files and file descriptions  of  a
  2008.                           single   directory   which    satisfy   the   set
  2009.                           definition.
  2010.  
  2011.           Options         Option (1) Write on existing files
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.                                         - 29 -
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.           Still River Shell                                            XDOS
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.           3.14 XDOS
  2056.  
  2057.  
  2058.           Command         XDOS
  2059.  
  2060.           Function        The XDOS  (execute  DOS)  command  allows  you to
  2061.                           execute  commands  under  DOS  from   the   shell
  2062.                           including prior command recall and  full  command
  2063.                           line edit.
  2064.  
  2065.           Operand 1       None.
  2066.  
  2067.           Operation       When  you  execute  the  XDOS  command,  you  are
  2068.                           presented with a standard  DOS prompt showing the
  2069.                           current drive and directory on the command line.
  2070.  
  2071.                           C:\DOC>_
  2072.  
  2073.                           You may enter any  DOS  command  string.  You may
  2074.                           edit  the  command  line with  the  normal  shell
  2075.                           command  line  edit features.  You may  enter  as
  2076.                           many commands as you  wish.   As  you execute DOS
  2077.                           commands and DOS responds, the shell screen moves
  2078.                           up  and,  eventually, off the display  as  it  is
  2079.                           replaced by the DOS dialogue.
  2080.  
  2081.                           You may recall a prior  DOS  command  line,  then
  2082.                           edit and execute it.
  2083.  
  2084.                           The command  line edit functions for XDOS are the
  2085.                           same as  the shell commands with the exception of
  2086.                           these special XDOS edit features:
  2087.  
  2088.                             -  <ESC>  -  clears the command line.   If  the
  2089.                                command line is  blank,  <ESC>  escapes  the
  2090.                                XDOS command presentation and returns to the
  2091.                                shell   command   selection    presentation.
  2092.                                Please note: the default <selected_drive> or
  2093.                                <selected_directory> may have  been  changed
  2094.                                by your DOS commands.
  2095.  
  2096.                             -  <UP/DOWN CURSOR> - replaces the command line
  2097.                                with the selected previous DOS command  line
  2098.                                from the command stack.  The  prior  command
  2099.                                line  stack  keeps  about 20  of  your  most
  2100.                                recent commands to DOS which you can recall,
  2101.                                edit and execute.
  2102.  
  2103.  
  2104.  
  2105.  
  2106.                                         - 30 -
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.           Still River Shell                                            XDOS
  2114.  
  2115.  
  2116.  
  2117.                           The DOS PATH command can not be used to alter the
  2118.                           system path while  under  XDOS; you must exit the
  2119.                           shell to update the system environment.
  2120.  
  2121.           Options         None.
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.                                         - 31 -
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.           Still River Shell                                  <function_key>
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.           3.15 <function_key>
  2188.  
  2189.  
  2190.           Command         <Fn>
  2191.  
  2192.           Function        The <function_key> executes a command line  under
  2193.                           DOS  including  the   state   of   the  shell  as
  2194.                           parameters.
  2195.  
  2196.           Operand 1       None.
  2197.  
  2198.           Operation       When a  Function Key, <Fn>, is entered, a command
  2199.                           line is executed under XDOS.  The command line is
  2200.  
  2201.                           <SRF><n><case>   <selected_set>   <default_drive>
  2202.                           <selected_file_path>         <selected_file_name>
  2203.                           <selected_file_extension>
  2204.  
  2205.                           <n>         the  number   of  the  <function_key>
  2206.                                       pressed
  2207.  
  2208.                           <case>
  2209.  
  2210.                                         -  A = <ALT>
  2211.  
  2212.                                         -  S = <SHIFT>
  2213.  
  2214.                                         -  C = <CTRL>
  2215.  
  2216.                                         -  <null> = <NORMAL> no shift.
  2217.  
  2218.                           <selected_set>
  2219.                                       (%1)    Current    set    description
  2220.                                       <drive><path><filename>
  2221.  
  2222.                           <default_drive>
  2223.                                       (%2) DOS default drive
  2224.  
  2225.                           <selected_file_path>
  2226.                                       (%3) DOS path,  less  drive,  of  the
  2227.                                       <selected_file>
  2228.  
  2229.                           <selected_file_name>
  2230.                                       (%4)   First  8  characters  of   the
  2231.                                       <selected_file> name or up to period
  2232.  
  2233.                           <selected_file_extension>
  2234.                                       (%5) Extension of <selected file>
  2235.  
  2236.  
  2237.  
  2238.                                         - 32 -
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.           Still River Shell                                  <function_key>
  2246.  
  2247.  
  2248.  
  2249.  
  2250.                           For   example,  if  you  pressed  <F8>  and   the
  2251.                           <selected_file>  was PROGA.C in \SYS\C  directory
  2252.                           in a LIST (*.C),  then  the  following command is
  2253.                           passed to DOS by the shell:
  2254.  
  2255.  
  2256.  
  2257.                           SRF8 C:\SYS\C\*.C C \SYS\C PROGA C
  2258.  
  2259.                           You must create a SRFn file  as  either  a  batch
  2260.                           file or program  for  every function key you plan
  2261.                                  2
  2262.                           to use.
  2263.  
  2264.                           To   make    <Function_Key_2>+<ALT>   cause   the
  2265.                           <selected_file> to execute:
  2266.  
  2267.                           Define SRF2A.BAT as:
  2268.  
  2269.                           %4.%5
  2270.  
  2271.                           When <F2>+<ALT> are pressed, the  shell  executes
  2272.                           the command line:
  2273.  
  2274.                           SRF2A C:\SYS\C\*.EXE C: \SYS\C PROGA EXE
  2275.  
  2276.                           Which generates:
  2277.  
  2278.                           PROGA.EXE
  2279.  
  2280.           Options         None.
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.           ----------
  2298.  
  2299.           2. See Shell Techniques for file definition  and  key  assignment
  2300.           protocols.
  2301.  
  2302.  
  2303.  
  2304.                                         - 33 -
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.           Still River Shell                                Shell Techniques
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.                                       Chapter 4
  2322.  
  2323.                        User Guide: Still River Shell Techniques
  2324.  
  2325.  
  2326.  
  2327.                  (Included in unabridged, printed documentation only)
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.                                         - 34 -
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.           Still River Shell                                   Command Usage
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.                                       Chapter 5
  2388.  
  2389.                             Reference Guide: Command Usage
  2390.  
  2391.  
  2392.  
  2393.                  (Included in unabridged, printed documentation only)
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.                                         - 46 -
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.           Still River Shell                              Window Definitions
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.                                       Chapter 6
  2454.  
  2455.                          Reference Guide: Window Definitions
  2456.  
  2457.  
  2458.  
  2459.                  (Included in unabridged, printed documentation only)
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.                                         - 51 -
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.           Still River Shell                                 Message Summary
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.                                       Chapter 7
  2520.  
  2521.                            Reference Guide: Message Summary
  2522.  
  2523.  
  2524.  
  2525.                  (Included in unabridged, printed documentation only)
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.                                         - 57 -
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.           Still River Shell                               Design Philosophy
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.                                       Chapter 8
  2586.  
  2587.                               A Little Design Philosophy
  2588.  
  2589.  
  2590.  
  2591.                  (Included in unabridged, printed documentation only)
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.                                         - 61 -
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.           Still River Shell
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.                                         Index
  2650.  
  2651.  
  2652.                  (Included in unabridged, printed documentation only)
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.